T
Entity type
IdeaBlade DevForce 2010 Help Reference
CreateEntity<T>() Method
See Also  Example Send Feedback
IdeaBlade.EntityModel Assembly > IdeaBlade.EntityModel Namespace > EntityManager Class > CreateEntity Method : CreateEntity<T>() Method



Create a new entity of the requested type.

Syntax

Visual Basic (Declaration) 
Public Overloads Function CreateEntity(Of T As Class)() As T
Visual Basic (Usage)Copy Code
Dim instance As EntityManager
Dim value As T
 
value = instance.CreateEntity(Of T)()
C# 
public T CreateEntity<T>()
where T: class
C++/CLI 
public:
T^ CreateEntitygeneric<typename T>
(); 
where T: ref class

Type Parameters

T
Entity type

Return Value

A new instance of the specified entity type

Example

C#Copy Code
DomainModelEntityManager mgr = new DomainModelEntityManager();

// Retrieve an order
Order order = mgr.Orders.FirstOrNullEntity(o=> o.OrderID == 1);
// Retrieve a product
Product product = mgr.Products.FirstOrNullEntity(p => p.ProductID == 1);

// Create an OrderDetail 
OrderDetail dtl = mgr.CreateEntity<OrderDetail>();
// assign key fields
dtl.OrderSummary = order;
dtl.Product = product;

// add the OrderDetail to the EntityManager cache
DebugFns.WriteLine("entity state before add = " + dtl.EntityState);
dtl.AddToManager();
DebugFns.WriteLine("entity state after add = " + dtl.EntityState);

Remarks

You may either "new" a business object (unless it's Abstract (or MustInherit in Visual Basic), or use one of the overloaded CreateEntity methods. Any new entity has a "detached" EntityAspect.EntityState until added to the EntityManager cache using either IdeaBlade.EntityModel.EntityManager.AddEntity or the object's IdeaBlade.EntityModel.EntityAspect.AddToManager method.

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

© 2013 All Rights Reserved.